Update INI Fields
The Update
INI Fields section replaces, adds, and deletes fields in the value of an
INI entry. Unlike an Update INI File section, an Update INI Fields section
replaces, adds, or deletes portions of a value in an INI file entry rather than
the whole value. The section name, update-inifields-section-name, must
appear in the UpdateIniFields item in an Install section of the INF file.
[update-inifields-section-name]
ini-file,ini-section,profile-name,[old-field],[new-field],[flags]
.
.
.
ini-file
Name of the
INI file containing the entry to change. For more information about specifying
the INI filename, see Update INI File Section.
ini-section
Name of the
INI file section containing the entry to change.
profile-name
Name of the
entry to change.
old-field
Field value
to delete.
new-field
Field value
to add, if it does not exist.
flags
Specifies
whether to treat the old-field and new-field
arguments as though they have a wild card character. The parameter specifies
which separator character to use when appending a new field to an INI file
entry. The flags argument can be any of the following values.
|
Bit |
Value |
Meaning |
|
0 |
0 |
(Default)
Treat the asterisk (*) character literally and not as a wild card character
when matching fields . |
|
0 |
1 |
Treat the
asterisk (*) character as a wild card character when matching fields. |
|
1 |
0 |
(Default)
Use a blank ( ) as a separator when adding a new field to an entry. |
|
1 |
1 |
Use a comma
(,) as a separator when adding a new field to an entry. |
The setup
functions remove any comments in the INI file line because they might not be
applicable after changes. When looking for fields in the line in the INI file,
the setup functions search for spaces, tabs, and commas as field delimiters.
However, a space is used as the separator when the new field is appended to the
line.